package com.guilin.system.service;

import com.guilin.domain.Alumni;
import com.guilin.dto.AlumniPasswordDTO;

import java.util.List;

/**
 * 校友信息Service接口
 * 
 * @author xiaoqi
 * @date 2025-06-07
 */
public interface AlumniService
{
    /**
     * 查询校友信息
     * 
     * @param id 校友信息主键
     * @return 校友信息
     */
    public Alumni selectAlumniById(Long id);

    /**
     * 查询校友信息列表
     * 
     * @param alumni 校友信息
     * @return 校友信息集合
     */
    public List<Alumni> selectAlumniList(Alumni alumni);

    /**
     * 新增校友信息
     * 
     * @param alumni 校友信息
     * @return 结果
     */
    public int insertAlumni(Alumni alumni);

    /**
     * 修改校友信息
     *
     * @param alumni 校友信息
     * @return 结果
     */
    public int updateAlumni(Alumni alumni);

    /**
     * 批量删除校友信息
     * 
     * @param ids 需要删除的校友信息主键集合
     * @return 结果
     */
    public int deleteAlumniByIds(Long[] ids);

    /**
     * 删除校友信息信息
     * 
     * @param id 校友信息主键
     * @return 结果
     */
    public int deleteAlumniById(Long id);

    /**
     * 校验用户名是否唯一
     * @param alumni
     * @return
     */
    public boolean checkUsernameUnique(Alumni alumni);

    /**
     * 校验手机号码是否唯一
     * @param alumni
     * @return
     */
    public boolean checkPhoneUnique(Alumni alumni);

    /**
     * 效验邮箱是否唯一
     * @param alumni
     * @return
     */
    public boolean checkEmailUnique(Alumni alumni);

    /**
     * 校友状态修改
     * @param alumni
     * @return
     */
    public int updateAlumniStatus(Alumni alumni);


    /**
     * 修改头像
     * @param alumni
     * @return
     */
    public boolean updateUserAvatar(Alumni alumni);


    /**
     * 更新校友密码
     *
     * @param id          校友ID
     * @param newPassword 新密码
     * @return 是否更新成功
     */
    public int updateAlumniPwd(Long id, String newPassword);


    /**
     * 根据用户ID查询校友信息
     * @param userId
     * @return
     */
    Alumni selectUserId(Long userId);

    /**
     * 根据用户名查询校友信息
     * @param username
     * @return
     */
    Alumni selectAlumniByUserName(String username);
}
